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INTRODUCTION 


P. K. Baltzer 


The STUDIO III system is an RCA CDP-1802 microprocessor based 
video game system. STUDIO III represents an extension of the 
earlier black and white, single-tone STUDIO II system. These 
systems have been designed to provide upward and downward 
software compatibility (STUDIO II games will play on STUDIO III 
as white images on a blue background, and STUDIO III programs 
will play on a STUDIO II system in black and white). 


The STUDIO II interpreter ROM and, therefore, the STUDIO II 
language are used in the STUDIO III system - to provide the 
above-mentioned software compatibility. The two new functions 
of STUDIO III are programmable image color, programmable back- 
ground color, and programmable sound. These features are 
implemented by machine- language subroutines in STUDIO III 
which can be called by the STUDIO II language, as described 
in the appropriate sections of this manual. 



STUDIO II LANGUAGE 
J. A. Weisbecker 
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DEBUGGING TIPS 


1. Always save a cassette copy of a newly entered program in case it destroys 
Itself upon a first run attempt. 

2. You can manually insert branches which loop on themselves to stop an undebugged 
program at any desired point. Examine registers and memory to determine if 
operation is proper to this point. Move breakpoint branch further along in 
program and try again. 

3. When using the interpretive Studio II in a RAM system remember 

that your program bugs can also destroy the language interpreter. Reload from 
cassette if you suspect that this has happened. 
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STUDIO II LANGUAGE 


OMMM - Execute Machine Language Routine at OMMM, P = 3, D4 to Return 
IMMM - Go to OMMM 

2MMM - Do Subroutine at OMMM (CO to Return) 

CO - Return from Subroutine 

3XMM - Go to MM (Same Page) If VX 00 

4XMM - Go to MM (Same Page) If = 00 

5XKK - Skip 2 bytes if VX KK 

6XKK - KK -J- VX 

70i]M - VO -1, Go to MM (Same Page) If VO ^ 00 (Note VO = 01 if No Branch) 

7XKK - If X 0; VX 4- KK 

8XY1 - VX/VY VX, VB 

8XY2 - VX.VY VX, VB 

8XY3 - VX © VY ■> VX, VB 

8XY4 - VX + VY VX (01 -> VB If VX + VY > FF, 00 -v VB If VX + VY - FF) 

8XY5 - VX - VY -V VX (01 -> VB If VX ^ VY, 00 -> VB If VX < VY) 

9XY0 - Skip 2 Bytes If VX ^ Tl 

9XY1 - VX 

9XY2 - M(08VY) VX 

9XY4 - VX M(08VY) 

9XY8 - VX -> M(08VY , VY + 1 , VY + 2) Decimal, VY(FINAL) = VY + 2 

AMl'lM - OMMM A (Memory Pointer), for TVA (TV address) . 

BNKK - KK •> M(A) , A + N (Same Page) 

CXKK - RR'KK VX, X 7^ 0 

DKMM - KEY(K) VB • Go to MM (Same Page) 

, "A" Key if VA = 1, "B" Key if VA = 0, Do next instruction if 
KEY(K) is not pressed. If K = F, Go to MM if KEY(VB) is 
pressed. 

EO - Erase V9 RAM Pattern 

El - Shift V9 RAM Pattern f (V9 Direction Byte) , NV/NH - 1 
Skip if direction ^ U/D/L/R (2/8/4/6) 

E2 - Shift V9 RAM Pattern f (VC), NV/NH-1, Skip if VC 3 * 

E4 - M(A) H Bytes XOR V9 RAM -> V9 RAM, A(FINAL) = A + H, Skip if H = 0 

E8MM - Have V9 RAM Pattern TV (XOR), Go to MM if Hit 

FXB6 - VX(LSD) A(LSD) , VX(FINAL) - VX • OF 

FXA6 - M(A) -> VX 

FXA9 - VX -> M(A) 

FXB3 - VX -> ALO 

FXAC - M(A) -> VX, A + 1 

FXAF - VX ^ M(A) , A + 1 

FX4D - Set X (Preset R6 for OMMM Next) 


8XY6 - VY/2-4VX, underflow-^ VB 

8XY1 - 2*VY-»VX, overflow->VB 

V9 " Current RAM Pattern # (00-07) 

VA = A/B Key Flag (01 = A, 00 ® B) 

VB = Arithmetic Overflow/Key Input Byte 

VC = Direction Byte 

VD = Tone Timer (Q On if VD 3 ^ 00) 

VE = Timer 

VF = Timer 


Special-Purpose 

Variables 


* Programs begin at 0400. In ROM systems 400-7FF program storage will be read only 
Do not use 3 byte COSMAC instructions in machine language routines. 
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STUDIO II ADDITIONAL STANDARD SUBROUTINES 


Keyboard Functions 

220B - Key debounce; Tone and debounce delay, Return after A/B 

Key Off f(VA) 

23C3 - Wait for A/B key release f (VA) 

23D8 - Read A/B direction key (2/4/6/8) into VB if pressed (tone + delay) 

waits for release of 2/4/6/8 otherwise sets VB = 00. 

Scorekeeping Functions 

2388 - A/B score -^-73, f(VA). Changes V2, V3, VB. 

A score = M(0881) , B score = M(0880) 

238F - A/B score + VI, f(VA). Changes V2, V3,VB. 

2368 - Show a/D score, f (VA) . 3 digit score shown. 

Changes .A(Meinory Pointer), VO, V2, V3, V9, VC. 

23A3 - Show A(Heinory Pointer) and B scores, 2 sec. delay 

Changes A(Memory Pointer), VO, V2, V3, V9, VA, VC, VE 
23D1 - Erase old A/B score and show new A/B score f(VA) 

Changes A(Meinory Pointer), VO, V2, V3, V9, VB, VC. New = old + VI 
23B0 - Sound warble tone and stop if A/B score - VI 

Changes V2, V3, VA, VB ■ 

Mlsc. Functions 

22F9 - Short tone + 160 ms delay 

0363 - Roll display down one spot position 

2336 - Write V9 RAM Pattern at TVA 

02F2 - Clear RAM page from M(A) to M(00) of specified page. 

229E - Repeat and shift V9 pattern: Write V9 pattern to TVA, 

Shift V9 Pattern f(VC),& Repeat VO times. 

233D - Sound warble tone 

2344 - Draw border (use only at beginning of program) 

2396 - Set A = pattern address, for digit at M(08V2) . V2-1. uses V3 

2372 - Show digits at M(08V3, V3-1, V3-2) f (V9) . Changes A/[Memory Pointer), V0,V2,V3, VC 
23BF - Sound warble tone and stop 

23E6 - Repeat RAM 1 pattern on TV screen. M(A) = list of TV destination 

address (TVA*s) for pattern in RAM 1. VO = number of entries 
in M(A) list of TVA*s. Preset RAM 1 H, in location 08F1, to pattern height. 
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COSMAC REGISTER UTILIZATION; 


R 

0 - DMA pointer for TV Refresh 

1 - Interrupt pointer for TV refresh subroutine 

2 - Stack pointer 

3 - Micro/machine language program counter 

4 - Call subroutine program counter 

5 - Macro program counter 

6 - 08CX at beginning of Macro. Used to address VX. 

(Do not change R6.1) 

7 - 08CY at beginning of Macro. Used to address VY. 

8 - Used in interrupt subroutine. 

9 - Random number storage. Incremented by 1 in interrupt subroutine. 

A - Memory pointer used by some Macros. 

B - Used in interrupt routine to initialize RO. 

Increment /Decrement by 08 to roll display. 

C,D,E,F, - used within Macro interpretive routines but can be used 

without conflict by user generated machine language routines. 

Timing Data- 

TV display circuits cause interrupts 60 times per second (16.7ms intervals). 
Interrupt routine requires 8 - 9 ms. 

VD, VE, VF are decremented by 1 at a rate of 60 times per second. 

No decrementing occurs when the variable =00. 

When VD-®2 a tone is sounded via the built-in speaker. 

Delays or tones up to 4 seconds long can be generated by setting VD/VE/VF to a 
value, and waiting for it to be decremented to 00. 

The following subroutine generates a 1 second tone. 

M Instr uction Comments 

400 6D3C 


402 3D02 


Set = 3C (decimal 60) and turn on tone 
Loop if VD?«00 
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STUDIO II MEMORY JJAP 


ROM 0000 

• t) 

• 0 

0 0 

ROM 03FF 

ROM 0400 

• • 

• • 

• • 

ROM 07FF 

RAM 0800 

• 080F 

• 0810 

• 081F 
0820 
082F 
0830 
083F 
0840 
084F 
0850 

• 085F 

• 0860 

• 086F 
0870 
087F 
0880 
08BF 
08C0 
08CF 
08D0 
08D7 
08D8 
08DF 

08E0 

08E7 

08E8 

08EF 

• 08F0 

• 08F7 

• 08F8 

RAM 08FF 

RAM 0900 

RAM 09 FF 


VGLl 

Interpretive 

Language 


User 

Programs 


RAM Pattern 0 


j Ram Pattern 1 
! RAM Pattern 2 


RAM Pattern 3 


RAM Pattern 4 

i j 

■ RAM Pattern 5 • 


RAM Pattern 6 


RAM Pattern 7 


TV Display 







Internal ROM 0.024 Bytes) 


External Card 

(1024 Bytes) 

Address Space 


RAM Pattern areas 

Addressed by V9 

8 patterns maximum 

128 Bytes reserved for patterns 

but can be used for other 

purposes when less than 8 

patterns are being 

manipulated. 


64 Byte stack (note that 
80-84 are used for scorekeeping) 

16, one byte variables (VO thru VF) 
TV Display • Address for Pattern 


TV Display parameter 
table (40 Bytes) 


16 Bytes 


TV Refresh RAM (256 Bytes) 


* Note; RAM 0800 thru 089F initially 

cleared to 00 

* Note : RAM 0900 thru 09FF initially 

cleared to 00 (blank screen) 
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180 VGLl - TV Display RAM Map (See Fig. 1 for Image Storage Locations) 



i 

32 Bits 




0900 

0901 

• • • 

0906 

0907 

0908 

0909 

• # • 

090E 

090F 

0910 

0911 

• • • 

0916 

0917 1 

• 

• 


• 

• 

• 

• 


• 

• 

i 

• 


• 

• 

j 09 FO 

09 FI 

1 

; # • • 

09 F6 

09F7 

09F8 

1 09F9 j 

i __ ! 

• • # 

09FE 

09FF 


64 Bits/Spots- 


Byte locations 0900 - 09FF are shown on the TV screen as 
indicated above: 


Each Byte is shown as follows: 


Bit 


7j 


ri’T 


..u 


rxnn 
U 


it 0 


Bit 6 — 
Bit 5 
Bit 4 


' Bit. 1 

i Bit 2 

— Bit 3 


* 1 = spot on (white) 

0 » spot off (black) 


Bit 7 of the Byte at M(0900) would be at the upper left 
comer of the TV screen and Bit 0 of Byte M(09FF) at the lower 
right comer. 


Keyboard Layout 


(EF3) 


A 

(LEFT) 


rr 

J. . . 

— 

2 

J 

3 I 

i 

i 

4 

5 

H 

6 i 

I 

7 



! 8 

L» I 

1 

0 

t 



B 

(RIOIT) 


1 

1 

2 

3 

4 

5 

6 

7 

8 

9 


0 



(EF4) 


Keyboard instructions use the 8 bit binary code for the 10 digit keys ^ 
Pattern Manipulation instructions use 2 for up, 4 for left, 6 for right, and 
8 for down. 




FIGURE 1 
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RAM PATTERN AREAS AND INITIAL CONTENTS 


"0" 0800 
0802 
0804 
0806 
0808 
080A 
080C 
080E 

"1" 0810 







0801 

0803 

0805 

0807 

0809 

080B 

080D 

080F 


081F I 

"2" 0820 ]|||[ 







083F i ~. 


0840 




084F 

0850 


085Fj 

0860' 




086F 

0870 

087F 


B SCOI 

r— 

E RAM 

A SCOP 

i 

£ RAH 



1 

i 

j 

i 

i 

j 


"4 


"5 


"6 


“7 


TV DISPLAY PARAMETER TABLE 





TVA 

JH 


DIR 

NV 


_NH 

RAMO 

-> 

08D0- 

- XX 

D8 - 04 

EO 

- xx; 

E8 - XX 

FO 

- XX 

RAMI 


D1 

XX 

D9 - 04 

El 

- XX 

E9 - XX 

FI 

- XX 

RAM2 

-> 

D2 

F8 

DA - 01 

E2 

- XX 

EA - XX 

F2 

- XX 

RAM3 


D3 

XX 

DB - 02 

E3 

- XX 

EB - XX 

F3 

- XX 

RAM4 


D4 

15 

DC - 05 

E4 

- XX 

EC - XX 

F4 

- XX 

RAM5 


D5 

11 

DD - 05 

E5 

- XX 

ED - XX 

F5 

- XX 

RAM6 

•> 

D6 

XX 

DE - XX 

E6 

- XX 

EE - XX 

F6 

- XX 

RAM7 


D7 

- XX 

DF - XX 

E7 

- XX 

EF - XX 

F7 

- XX 


Note 1 XX - Unknown initially 
Note 2 0880 = B score Byte 

0881 = A score Byte 

0882,3,4 « Temporary storage for Byte to 3 digit decimal 
conversion routine. 
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RAM PATTERN MANIPULATION RULES : 


Ram Pattern Space (16 Bytes) 








X Y 

■A Av 


— 1 — t t -t- l — t—t— 

— 1 — i — 1 — h-H — 1—1 — 













A A. .A ^ A 


^ i 1 » — I 1 » i 

7654321076543210 


E4 Instruction: 

Moves H. bytes from M(A) 

into X bytes of RAM pattern space 

starting at top. 


H = Pattern Height 


J H Byte 


7 6 5 4 3 2 1 0 



H “ 1 to 8 


J = 0/8 


Right Shift Rules: (l-s»>X Y 1 ) 

If X bit 0 = 1 and J = 0, 8 J and TVA + 1 

If Y bit 0=1 and J = 8, 0 J and TVA +1 


Left Shift Rules: ( I X ^ Y ^ ■ — I ) 

If Y bit 7 = 1 and J = 0, 8 J and TVA - 1 

If X bit 7 = 1 and J = 8, 0 J and TVA - 1 

Up Shift = TVA - 08 
Dovm Shift = TVA + 08 
E8 Instruction: 

If J = 0, X TVA and Y TVA - 01 

If J = 8, Y TVA and X TVA - 01 


( E1/E2 Instructions 


J 


*Note: Maximum pattern size = 8 bits x 8 bits 
for normal operation 
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STUDIO H - PROGRAMMING EXAMPLES 


' Moving a spot around the screen (19 Bytes) 


0400 

6903 

Let V9 « 03 ( 

spot pattern RAM) 

0402 

6A01 

Let VA = 01 (select a keyboard) 

0404 

A8D3 

Let A <= 08D3 

(TVA for RAM 3 pattern) 

0406 

B000 

00 ^ M(A) (Let TVA3 = 00) 

0408 

E80A — 1 

Show V9 RAM pattern 

04 0A 

23D8 

A direction Key/00 VB 

040C 

9BC1 

VB VC 


040E 

E810 — 1 

Erase pattern 


0410 

E2 

Shift pattern 

f (VC) 

0411 


Repeat 


0413 




New 2/4/6/8 Key/00 VB 

Subroutine (16 Bytes) 

0500 

D20B 

Key 2 -> VB -j- 


0502 

D40B 

Key 4 -»■ VB 


0504 

D60B, 

Key 6 -»■ VB 


0506 

DSH. 

Key 8 -> VB -> 


0508 

6B00 

00 VB 


05 0A 

C0 

Return 


050B 

6F01 

01 -> VF 


050D 

3F0D 

Wait for VF = 

00 

JO50F 

00 

Return 


Change M(040A) 

to 2500 

for continuous, 

fast, soundless 

spot motion 

when direction key is pressed. 

Make following 

changes 

to eliminate blinking while 

spot is stationary. 



04 0E 

4C0A 

Go to 040A if VC = 00 

0410 

E812-] 

Erase pattern 


0412 

E2 

Shift pattern 

f (VC) 

0413 

1408 

Repeat 0408 


0415 
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STUDIO II-PROGRAMMING EXAMPLES 


Generate Key selected to: 


Start -> 0400 

6A01 

0402 

6B09 

0404 

DF0C 

0406 

4B02 

0408 

7BFF 

040A 

1404 

040c 

9BD1 

040E 

3D0E 

0410 

9BE1 

0412 

3E12 

0414 

0500 

0416 

140c 

0418 

1402 

041A 

— 

Machine'’“0500 

3604 

Lang. 0502 

1515 

Sub- 0504 

routine 

D4 

Randomly moving 

spot (: 

0400 

6903 

0402 

A500 

0404 

0406 

E806 — 1 
C103 -J 

0408 

F1B3 

040A 

FCA6 

040 C 

6F04 

04 0E 

3F0E 

0410 

E812 — 1 
E2 

0412 

0413 

1404 

Table -> 0500 

02 

0501 

04 

0502 

06 

0503 

08 


sequence (31 Bytes) 

(select a keyboard) 


01 

09 


Go to 0C if VB key on ■ 
Go to 02 if VB = 00 


Set VA = 

I^Set VB = 

VB - 01 

Repeat 

^VB -y VD (tone on) 

Wait for VD = 00 (tone off) 

VB -> VE (Set delay) 

Wait for VE = 00 (end delay) 

Skip next instruction if EF3 = 0 
Loop 

Go to 


EF3 = 1? Yes — 
R5 + 1, R5 + 1 
Return <- 


Let V9 = 03 (spot pattern RAM) 
Let A = Table 

Show spot < 

RR*03 ^ VI 
VL -> ALO 
M(A) VC 
04 -> VF 

Wait for VF = 00 
Erase spot 
Shift spot f (VC) 

Repeat 


Up 

Left 

Right 

Down 
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sifeio II - PBOGRAMMIlfG EXAMPLES 


Showing a keyboard digit on TV (30 Bytes) 


0400 

6A01 

0402 

6904 I 

0404 

6B09 

0406 

DF0E 

0408 

4b02 

040A 

7BFF 

040c 

1406 

040E 

A210 

0410 

FBB6 

0412 

F1A6 

0414 

F1B3 

0416 

E818 — j 

0418 

E0 

0419 

E4 

041A 

E81C — 1 

041 C 

1406 

041E 


Random 

Bytes on 

0400 

6A01 

0402 

2368 

0404 

CIFF 

0406 

23D1 

0408 

6F0F 

04 0A 

3F0A 

040C 

1404 


(sel. A keyboard) 
(sel. RAM 4 space) 


Let VA = 01 
-Let V9 = 04 
09 -> VB 

Go to 0E if VB key on 
Go to 02 if VB = 00 
VB - 01 

Repeat 

210 A (Dec. Dig. to pattern table) 
VB(LSD) -i- A(LSD) 

M(A) -»■ VL 
VI ->■ ALO 

Show RAM f (V9) - Erase TV 
Erase RAM pattern f (V9) 

M(A) pattern RAM f (V9) 

Show RAM f (V9) 

Repeat 


/ in 3 decimal digit format (14 Bytes) 

01 •> VA (select a score) 

Show A/B score f (VA) 

RR. FF VI 


Erase Old A/B score and show New + VI 
0F VP 

Wait for VF = 00 

Repeat 



PROGRAMMING COLOR 


P. K. Baltzer 
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A color-map technique is used in STUDIO III to define the color of the 
image (or ”Luminence”) information, written using the STUDIO II language. 

The above colored image information is shown by the STUDIO III on a uniform 
programmable color background , which is separately defined using a special 
COSMAC I/O instruction. Since neither the image color nor the background 
color are explicitly considered in the STUDIO II language, these functions 
must be implemented in STUDIO III using machine -language subroutines called 
by the STUDIO II instruction OMMM. Each function will be separately described 
and examples of typical machine code subroutines given. 

Image Color Programming 

Image color is defined in terms of blocks covering 4x8 areas of image spots. 
Images or parts of images occupying the same color block will have the same 
color. There are 64 color blocks in the display field and each block can be 
any one of eight colors. The information defining these 64 color blocks 
must be placed in the 64 consecutive locations OBOO to 0B3F. The geometric 
correspondence of these memory locations and the actual display is indicated 
in Fig. 1. Each of the above memory locations must have one of the following 
byte codes, corresponding to the desired color: 

00 - Black 

01 - Red 

02 - Blue 

03 - Violet (blue & red) 

04 - Green 

05 - Yellow (green 6e red) 

06 - Aqua (green & blue) 

07 - White. 

When the STUDIO III system is cleared (or reset), the system hardware 
initializes to an all white luminence, which will remain so until the color 
map memory OBOO - 0B3F is addressed by software. Note that the STUDIO II 



r 


Tum 


xrm 

OBOt 


xnrr 


JTUT 


nr 


TTTrm 

0B06^ 


Tttttt 

; OBOT 


OBOO 




tt+ti 

0B09 


0B02 


0B03 


t-H- 


0B04 


-T -y—h 

t- r H +H 


^0B05 


OBOD 


0B08 


OBOA 








- OBOB 

T~rT“T — T 


OBOC 


OBOE 


OBOF 




T : 






JU-L 


OBIO 


OBI I 


OB I 2 


OB 13 


T 

OB I 8 




OB 1 4 

-r~T-T^~ 


OBIS 




0BI6 

"1 ' — ! 


OBIT 


■■I.- 4. t.. 


IX 


OB 19 


OBIA 




t ' r 

' ■ 1 . " t -i 


OBIB 


OBIC 


OBID 


OBIE 


i i i L 


OBIF 


t 


-f — ? — r 


if 


0B20 


0B2I 


OB22 


OB23 


OB 24 


0625 


4-4-4- 




4 - 4 - 


-h-t- 


J- 


0B26 


0B2T 


TTT 


0B28 


-) — I — r- 

-H-t- 


0B29 

' ' 7 ~r 


0B2A 


0B2B 


0B2C 

! - I ■- 


0B20 


0B2E 


X-L_I- 






-! — ' — ^ — r 


062F 

'lit 




i0B30 

TT ! I ! r 


0B3I 


0B32 


0633 


i ■ *-M 




0B34 


0B35 


0B36 


0B3T 


i_L 1 i 


-i.-a.-i. 


0B38 


0B39 


IT] ITT' 


063A 




0B3B 


0B3C 


I I I i 


TTII 'fT 


0B3D 

Til i'l n 




0B3E 

' ' r r- ^ - 




i 0B3F 

TTTTI X 


COLOR MAP STORAGE LOCATIONS 


FIGURE 1 
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interpreter erases all spot memory before first executing the starting 
op-code at location 0400 » Therefore, it is good practice to program the 
initial state of the color map before any images are written on display. 

* 

A typical program for setting a consecutive number of color map locations 
(such as the bottom row of color blocks) to a single color is given below: 


Memory Location 


STUDIO II 
Op Codes 


Main Program 


0440 

0442 

0444 


AB38 

0500 


^ \ 

No. of Color 

blocks (red) 


Set A to first location in color -map. 
Call machine language subroutine at 
location 0500. 

Data for machine language subroutine. 



Machine 
Language Code 

0500 

45, AF 

0502 

45, AE 

0504 

8E,5A,1A 

0507 

2F,8F,3A04 

050B 

’d4 


Subroutine 


Read No. of blocks and put low Reg.F. 
Read color and put low Reg. E. 

Get low E and store M(A) ; Inc. A 1 

Dec. F; get low F and branch if ^ 0.— ^ 
Return 



Courtesy of A. A. Modla. 
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A typical machine language subroutine that could be used is given below: 


Memory Location 

Machine Code 


Explanation 

0600 

EF,61* 

Set 

X=F, Sequence Background 

0602 

EF,61 

Set 

X=F, Sequence Background 

0604 

EF,6r 

Set 

X=F, Sequence Background 

0606 

D4 

Return 


To sequence background blue to red call program at 0600; to sequence 
background blue to green call program at 0602; and to sequence background 
blue to black call program at 0604. 


Note that this **61" instruction applies to an actual STUDIO III system. 
Since the VIP normally uses this instruction to turn off the video chip, 
programs run on an unmodified VIP should use the **65’* instruction in the 


above program. 



PROGRAMMING SOUND 


J. J. Winsor 
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This programmable tone generator is designed to produce 255 
possible frequencies from a single frequency input clock. It 
is directly compatible with the CDP 1802 microprocessor. An 
eight bit data input allows programming the divide rate of the 
tone generator, A fixed internal predivide scales the input 
clock down so that the programmable divide rates all provide 
frequencies in the audio range. 
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FREQUENCY DIVISION OF STUDIO III TONE GENERATOR 


3.579545 MHz 
;2 = 1.789772 MHz 
;8 = 223.721 KHz 
;8 = 27.965 KHz 


Color Frequency 

Clock for Studio III Prototype 

TPB 1802 mP Signal 

Maximum Frequency Without 
Programmable Divide Rate 


fN Variable divide rate which can be altered by 
program. Divides the maximum frequency by 1 
through 255 (Olj^g through FF]^ 5 ) . Hex value 
represents programmed divide rate which is a 
delay or inversely proportional to the resulting 
frequency. 

If N = 01 Resulting frequency = 27.965 KHz 
If N = FF Resulting frequency = 108 Hz 

To calculate the proper hex code to provide a given frequency divide 
27.965 KHz the maximum frequency by the frequency you want to attain, 
round off, and convert the resulting number to Hex. 

1^(27.965 KHz / Desired Freq.) + . 5 j — » HEX 

GENERAL INFQRMAT ION 


In the Studio Il/lII System there are no interpretive instructions to handle 
programming the tone generator. This requires the user to call machine language 
subroutines to control this operation. 


The Studio III Prototype System provides for an initial frequency to be 
programmed into the tone generator. The purpose of this is to allow the 
older Studio II cartridges, which have no tone programming operations, to 
be plugged into a Studio III and have the same tone as in a Studio II. 


In addition to programming the frequency of the tone generator the tone itself 
must be turned on and this can be done by an interpretive instruction. Loading 
variable D With some value turns the tone on. This value is decreased by 1 
during each execution of the display refresh until Variable D equals 0 and then 
the tone is turned off. In this manner single tones up to 4 seconds long can 
be created. 


prcx;ramming the tone generator 


Programming the frequency is not as easy as turning on the tone. First an 
interpretive instruction which calls a machine language routine must be used. 

The machine routine must execute a 64 instruction to program the tone generator 
with the desired value. This is an output instruction and so must refer to some 
memory location. This location can be pointed to by any register and that register 
must be pointed to by the X register. 
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The values used to program the tone generator may be stored in a table of 
data. This will require that some register be set up each time the routine 
is executed, before the X register is set and the 64 instruction used. This 
is useful for strings of tones. 

Alternately the values used to program the tone generator may be combined with 
the interpretive or machine language code. This only requires setting the X 
register equal to the program counter of the code with which the data is 
combined. 

Example 1 = Table of Tones 

the values are stored in a table in memory 

the first location of the table is set into a RAM memory location 
by program 

the data at the RAM location is set in some machine register 
the X register is set to the number of the machine register 
a 64 instruction loads the data into the tone generator and 
increases the value of the pointer register by 1 
the value of the register is saved in the RAM location 
steps c through f are repeated for each new frequency to be 
programmed into the tone generator 

Example 2 = Tone Data Combined with Instructions 

a) set X register to point to the interpretive code counter register 

b) execute a 64 instruction 

c) return to interpretive code 


Code for Example 2: 


Interpret 

ive Code 

Machine Code 



Mem. Loc. 

Instruction 

Mem. Loc. 

Instruction 

• 

• 

• 

• 

0600 

E5 

X=5 

0480 

0600 Machine Call 

0601 

64 

Output RX+1 

0482 

0483 
• 

• 

B5 Data 

• 

• 

• 

• 

0602 

D4 

P=4 


a) 

b) 

c) 

d) 

e) 

f) 

g) 


The Interpreter Program Counter for Macro Code is R5. Interpretive 
instruction 0600 branches to the machine routine at address 0600. 
The X pointer points to R5. The 64 instruction outputs the data, 
B5, to the tone generator and increments R5 so that returning to 
interpretive code picks up at location 0483. 

HOW IT WORKS 


As the 64 instruction is implemented, the data at the memory location, pointed 
to by the register indicated by X, is put onto the bus. The 64 instruction also 
causes output line N2 of the 1802 to go high. This is ANDed with TPB of the 1802 
to create a strobe at the time the data is valid on the bus. 
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This strobe is used to latch the data into the 8 bit latch of the tone 
generator as shown in Figure 1. The clock feeding the tone generator is 
scaled down and further divided by the programmable counter* When the 
counter gets down to zero, the Output Flip Flop toggles and the output 
also toggles provided the output enable is high. At the same time the 
Load Flip Flop causes the contents of the latch to preset the programmable 
counter to the desired divide rate. It can be seen that the latch is 
operated independently of the counter circuit. 
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DATA 0-7 

RESET (BUS) N2 TPB 



CLOCK OUTPUT OUTPUT 


ENABLE 

BLOCK DIAGRAM - PROGRAMMABLE TONE GENERATOR 


FIGURE 1 








STUDIO II INTERPRETER 


J. A. Weisbecker 




STUDIO II INTERPRETER 


LABEL 

LOCATION 

CODE 

DESCRIPTION 

START 

0000 

90 B1 

00-*Rl.l 


02 

B4 A5 AB 

00-»R4.1,R5.0,RB.0 


05 

F8 08 

0&-»D 


07 

B2 B6 B8 

08-»R2.1,R6.1,R8.1 


OA 

F8 1C A1 

"INT'i+Rl.O 


OD 

F8 BF A2 

"STK" R2.0 


10 

F8 6B A4 

''CALL"-»R4.0 


13 

F8 03 B5 

03+R5.1 


16 

D4 

GO T0-»0300 (MACRO) 


OEI 

>0017 

7A 

END I 

>0018 

42 F6 


lA 

42 70 

INT 

>001C 

22 78 


IE 

22 73 


20 

CO 00 23 


23 

7E 52 


25 

19 


26 

F8 09 BO 


29 

F8 DO A8 


3C 

8B A0IE2 


2F 

20 A0IE2 


32 

20 A0IE2 


35 

20 A0I80 


38 

20 AOI 


3A 

3C 2F 


3C 

20 AOl 


3E 

34 3C 


40 

28 


41 

08 32 ^ 


44 

FF 01 58 


47 

88 FB CD 


4A 

3A 40 


4C 

08 32 17 


4F 

7B 30 18 


04Q ( 

STK-*D,STK+l,mDF 

STK-»D , STK+1 , STK-4XP , STK+1 

STK-1,T-»STK 

STK-1,D-»STK,STK-1 

LONG GO TO r 

DF-*D-»STK i — I 

R9+1 

09-»R0.1 

"D0"->R8.0 (VF+1) 
RB.O+RO.O 

< 1 

(1=8 DMA CYCLES) 


EF1=1? NO 

< 

EF1=1? YES 

R8-1 4 

M84D,D=00? yes — 
D-01-»M8 

R8.0->D,D®CD <— 

D=00? NO 

M8 D,D=00? YES — 
1-»Q, GO TO END I 


CXKK 


TV ON 


4 0052 

19 

89 

AE 

55 

93 

BE 


57 

99 

EE 

F4 

5A 

56 



5B 

F6 

E6 

F4 

5E 

B9 

56 


60 

45 



61 

F2 

56 

D4 

64 

00 



5 

00 



4 0066 

E2 

22 

69 

69 

12 

D4 



9+l,R9.0+RE.0 

00+RE.l 

R9.1-*D,E-»X,D4ME 

D-»M6 

SH.R,6-^X,D+M6 

D-»R9.1-»M6 

M5+D.5+1 

D»M6-»M6,RET 


SPARE 


2-»X,STK-l, TV ON (BUS-»STK, 
STK+1, RETURN 


D) 
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LABEL LOCATION CODE 


CALL 5 006B 96 B7 

P=4 6D 94 BC 

6F 45 AC 

72 F6 F6 

74 F6 F6 

76 32 % 

78 F9 EO 

7B 8F FA 

7E F9 CO 

81 05 F6 

84 F6 F6 

86 F9 CO 

89 4C B3 

8C FC OF 

8F 4C 

90 A3 D3 

92 30 6B 

M.L. > 0094 8F 

95 FA OF 

98 45 30 


DESCRIPTION 

08-»R7.1 

00-*Rl.C (MACRO DECODE TABLE) 
AF M5-»D,5+1,D->RC.0,D-»RF.0 

SHR.SHR 
SHR,SHR 

D=00? YES--4M.L. 

AC D/EO^RC.O 

OF RF.0-»D,D.OF 

A6 D/CO»R6.0 [08CX-»R6] 

F6 M5-»D,SHR,SHR 

SHR.SHR 

A7 D/C0-»R7.0 [08CY-4R7] _ 

8C MC-»D,C+1,D->R3.1,RC.0-»D 

AC D+OF-*RC.O 

MO»D.C+l 

D-»R3.0,3r»P-»I.L.-, < 1 

GO TO--* CALL *-i 

RF.0-»D < 

B3 D»OF-4R3.1 

90 M5*D,5+1, GO TO > 


|8XYN| 


^ 009B 

22 

E2 

STK-1,2-»X 

9D 

F8 

D3 73 

"D3''^STK,STK-1 

AO 

45 

F9 FO 

M5+D,5+l,D/FO 

A3 

52 

E6 

D4STK,64X 

A5 

47 

D2 

M74D,7+1,2-»P (EXEC 

A7 

56 


D4M6 (RESULT VX) 

A8 

F8 

CB A6 

"CB'i»R6.0 

AB 

91 

7E 

004D,DF4D,VB 

AD 

56 

D4 

D4M6, return 


2 STK. INSTR.) 




|6xkkI 



OOAF 

86 

FB 

CO 

R6.04D,D«C0 


B2 

3A 



D»00? NO — >CXKK 


B4 

42 

B5 


STK-4R5.1,STK+1 


B6 

42 

A5 

D4 

stk+r5.o,stk+i,: 

■> 

00B9 

45 

56 

D4 

M54M6,5+1,RET. 


OOBC 

64 

lOOio 

OOBD 

OA 

lOlO 

OOBE 

01 

^10 


I3XMM1 

GO TO MM IF VX^^OO 
l4XMMt 

GO TO MM IF VX=K)0 


I2MMMI 
BR. & LINK 

1 IMMMI 
GO TO OMMM 


OOBF 

06 

3A 

C7 

C2 

15 

D4 


00C4 

06 

3A 

C2 

C7 

05 

A5 

D4 


OOCA 

15 

85 

22 

CD 

52 

95 

22 

DO 

52 

25 


00D2 

45 

A5 


D4 

86 

FA 

OF 

D7 

B5 

D4 



M64D, D=>00? NO 1 

5+1, RETURN 4 — i 
M64D,D=00? no—* 
M54D,D-»r5.0 returns — • 


5+l,R5.0+D,STK-l 
D4STK,R5.1 D,STK-1 
D+STK,5-1 
M5+D,5+1,D R5.0 
R6.0-»D,D#0F 
D4R5.1, RETURN 
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LABEL 

LOCATION 

CODE 

1 AmmmI 

^ 00D9 

86 FA OF 

OMMM+A 

DC 

BA 


DD 

45 AA D4 

I TABLE 

> OOEO 

00 

Rl 

1 

00 


2 

00 


3 

00 


4 

00 


5 

02 


6 

00 


7 

02 


8 

00 


9 

02 


A 

00 


B 

02 


C 

00 


D 

02 


E 

01 


F 

02 

I TABLE 

^ OOFO 

00 

RO 

1 

D2 


2 

CA 


3 

BF 


4 

C4 


5 

4E 


6 

B9 


7 

3D 


8 

9B 


9 

56 


A 

D9 


B 

E5 


C 

AF 


D 

BF 


E 

00 


F 

A4 


DESCRIPTION 


R6.0-*D,D*OF 

IHRA.l 

M5>RA. 0,5+1, RETURN 




LABEL 


LOCATION CODE 


DESCRIPTION 


M — 

— > 0100 

F8 C9 A7 

p ** 3 

03 

07 FE FE 


06 

FE FE A6 


09 

F8 DO 


OB 

E7 F4 A7 


OE 

F8 02 BC 


11 

F8 92 AC 


14 

DC 10 


16 

OF BD 


18 

DC 08 OF 


IB 

FA OF AE 


IE 

OF 


IF 

FA 80 BE 


22 

07 AD 


24 

25 45 


26 

F6 33 4E 


29 

F6 33 49 


2C 

F6 33 3D 


2F 

F6 33 BC 

EO 

— ^ 0132 

F8 10 AF 

ERASE V8 

35 

91 56 16 

RAM PATTERN 

38 

2F 8F 

(ALL 16 BYTES) 

3A 

3A ^ 


3C 

D4 



— > 013D 

E6 


3e 

8E 32 3C 

M(A)H BYTES 

41 

4A F3 56 

RAM (XOR) 

44 

16 16 2E 

SKIP IF H»0 

47 

30 ^ 

E2 

—4 0149 

F8 CC AF 


4C 

OF BD 

El 

— > 014E 

9D FB 02 

SHIFT RAM 

51 

32 63 

PATTERN 

53 

9D FB 08 


56 

32 ^ 


58 

9D FB 04 


5B 

32 97 


5D 

9D FB 06 


60 

32 72 


62 

D4 


"C9'1^R7.0 

M7-»D,SHL,SHL 

SHL,SHL,D-»R6.0 

"D0"-4D 

7-^X,MX+D-»R7.0 

02-»RC.l 

"SET RF'L»RC.O 

SET RF«DIRECTION BYTE 

MF-4RD.1 

- i-Q 

SET RF=JH,MF-»D 10 

D«0F RE.O 

MF->D 

D«80 RE.l 
M7-+RD.0 

5- 1,M54D,5+1 
SHR,DP»1? YES-4E1 
SHR,DF=1? YES— j>E2 
SHR,DF=1? YES— >E4 
SHR,DF=1? YES— ^E8MM 

10-»RF.0=N 

00-»M6,6+l < 

RF-1,RF.0^D 

D=00? NO 1 

RETURN i 1 

6- »X 

r^RE.0*»D,D»00? YES, H=00 » 

MA-^D,D®16^M6,A+1 

6+l,6+l,E-l 

L-REPEAT 

CC-*RF.O 

MF-»RD.l RD.1»VC DIRECTION 

BYTE 

RD.1->D,D®02 
D“00? YES — >SH.V. 

RD.1-4D, D©08 
D^O? YES— >SH.D. 

RD.1->D,D«04 
D=00? YES — >SH.L 
RD.1->D,D®06 
D=00? YES— ♦SH.R. 

RETURN (DIR .7^02/04/06/08) 



LABEL 


LOCATION CODE 


DESCRIPTION 


SHV 


SHD 


SHR 


SHL 


0163 

07 

FF 

08 

66 

57 



67 

DC 

18 


69 

93 

F5 

5F 

6C 

D4 



016D 

07 

FC 

08 

70 

30 

66 


0172 

8E 

32 

F9 

75 

06 

F6 

56 

78 

3B 

81 


7A 

9E 

3A 

81 

7D 

F8 

80 


7F 

BE 

ID 


81 

16 

06 


83 

76 

56 


85 

3B 

93 


87 

26 

06 


89 

F9 

80 


8B 

56 

16 


8D 

9E 

32 

93 

90 

91 

BE 

ID 

93 

16 

2E 


95 

30 

72 


0197 

8E 

32. 

.F9 

9A 

06 

FE 

56 

9D 

3B 

A5 


9F 

9E 

32 

A5 

A2 

91 

BE 

2D 

A5 

16 

06 


A7 

7E 

56 


A9 

3B 

B8 


AB 

26 

06 


AD 

F9 

01 


AF 

56 

16 


B1 

9E 

3A 

M. 

B4 

F8 

80 


B6 

BE 

2D 


B8 

16 

2E 


BA 

30 

97 



M74D(TVA) D-08 
D4M7 <■ 


+?4 

SET RF=NV 10 

0]r*D,MX-D-»MF 

RETURN 

M7<»D(TVA),D+08 
GO TO 


TVA-8 


NV-1 


TVA+8 


RE.0-»D,D=00? YES H=00-+END SR/SL 
M6-»D,SHR-»DF,D-»M6 

DF=1? NO XO ^ 

RE.l-»D,D-00? NO Jl ^ 

80-»D 

D-»RE . 1 , RD+1 [l-4J , TVA+l] 

6+1 ,M64D f — 


SHR DF+D-»DF,D+M6 

DF+1? NO YO — 

6-l,M6+D 

D/80+D 

D-»M6,6+1 

RE.l+D,D-00? YES JO — 

OO+RE . 1 , RD+1 [O+J , TVA+l] 
6+1, E-1 [h-1] < — 

REPEAT 


(-4RE*04D,D»00? yes H-OO+END SR/SL 
M6-»D,SHL+DF,rBM6 
DF=1? NO XO ^ 


RE.1->D,D**00? YES jO > 

00^RE.1,RD-1 [0+J,TVA-l] 

6+1 ,M6-»D < 

SHL DF-*D^DF,rMM6 

DF=1? NO YO ^ 

6-l,M6^D 

D/Ol+D 

D-»M6,6+1 


RE.1+D,D*00? NO Jl — 

80+D 

D-»RE.1,RD-1 [l+J,TVA-l] 

6+1, E-1 < 

-REPEAT 
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LABEL LOCATION CODE DESCRIPTION 


E8MM 

> OIBC 

93 

BC 


01-»RC.l 

MOVE RAM 

OIBE 

F8 

EB 

AC 

XX-»RC.0 

PATTr>TV 

Cl 

91 

AF 


00-»RF.O 1rF.0=HIT FLAcO 

GO TO MM 

C3 

9E 

32 

D4 

RE.lr*D,D=00? YES, J=00- 

IF HIT 

C6 

2D 



RD-1 (JVAq-D 


C7 

8E 

32 

11 

-^RE.0-*D,D=00? YES,H=00- 


CA 

DC 

ID 


D0XXM6-»MD, 6+1, D+1 


CC 

DC 

8D 


D0XXM6-#MD, 6+1,RD.0*»D 


CE 

FC 

07 

AD 

D+07+RD.0 


DI 

2E 

30 

C7 

1— E-1 Ch-IU , REPEAT 


D4 

8E 

32 

£1 1 

->RE.a*D,D=00? YES,H*00 


D7 

DC 

2D 


D0XXM6+MD,6+1,D-1 


D9 

DC 

8D 


DOXXM6+MD , 6+1 , RD . 0+D 


DB 

FC 

09 

AD 

D+O9+RD.0 


DE 

2E 

30 

D4 1 

L— e-i[h-2 repeat 

T7TJr> MnVF — — 

\ nipi 

fil? 


E6 

PF NO PREV* 

SUViU rlvV Jit ■ 

E4 

or 

15 

D4 

5+1, RET. 


E6 

05 

A5 

D4 

M5-*D , D+R5 . 0 , RET . 4 


END 

MO^ 


END 

MOVE 





01E9 

16 D3 

6+1, RET. TO P3 

XX 

) OlEB 

F8 09 BD 

09+RD.l 

M6+MD 

FE 

ED 06 F2 

D+X,M6^D, D*MX 

P=C 

FI 

32 F4 

D=00? YES - NO HIT-, 


F3 

AF 

D+RF.o (Hit fla^ 


F4 

06 F3 5D 

M6+D, D®1X+MX+- 1 


F7 

30 E9 

GO TO 


END SR/SL 

G1F9 

FC 

DC ^ 
FF 01 

OF 

5F 

SET RF=NH BYTE +32io>MF+D 
D-OHMF Dra-Q 


FF 

DC 08 

OF 

SET RF=JH BYTE + 8^q,MF+D 


0202 

FA OF 


D*OF-»D [piO 


04 

5F 9E 

FI 

D+MF,RE.1-+D,D/MF+D 


07 

5F 


D+MF [SET NEW j] 


08 

8D 57 

D4 

RD.04M7 [restore TV^ RET. 

KEY DEBOUNCE — 

— > 020B 

22 F9 


DO TONE + DELAY 


020D 

23 C3 


DO WAIT FOR A/B KEY OFF 


02PF 

CO 


RETURN 

DEC.PATT. 

0210 

2F 



TABLE 

11 

lA 




12 

25 




13 

IF 



i 

14 

38 




15 

23 




16 

27 




17 

33 




18 

29 




19 

2B 
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Decimal display pattern table (35 Bytes) 


M Byte 


If 


021A 

60 



IB 

20 



1C 

20 



ID 

20 



IE 

70 

"3" 

->• 

021F 

FO 




10 




70 




10 

iijii 

-> 

0223 

FO 




80 

"2" 


0225 

FO 



26 

10 

••6" 


0227 

FO 



28 

80 

fig" 


0229 

FO 



2A 

90 

iigfi 

-> 

022B 

FO 



2C 

90 



2D 

FO 



2E 

10 

"0" 


022F 

FO 



30 

90 



31 

90 



32 

90 

fly If 


0233 

FO 



34 

10 



35 

10 



36 

10 



37 

10 

"4" 


0238 

AO 




AO 




FO 




20 




20 


Pattern 

76543210 
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lABEL 


LOCATION 


DESCRIPTION 


7XKKI 

VX-HCK 

VXftVO 


VO-1 

GO TO MM 
IF VX=V0 


86 FA OF 
32 4j7 
E6 45 
F4 56 D4 

06 FF 01 
3A El 
15 
D4 


R6.0*D,D.0F 

D=00? YES »70MM- 

6*X,M5-*D,5+1 

MX+D-»M6,RET. 


M6-*D,D-01i 
D=00? NO- 
5+1 

RET. 4 


D+M6,M5^>R5. 

RETURN 


5XKK1 

SKIP 2 
IF VX#KK 


9XY2 > 

M(08VY)+VX 

9XY4 > 

VX+M(08VY) 

9XY8 > 

CONV.VX 

TO 3 DEC .DIGITS 
M(08VY,VY+l,VY+2) 


0270 

73 

75 

78 

79 
7C 
7E 

80 
82 
85 
87 
89 
8B 
8D 


45 

E6 F3 
32 ^ 

15 15 D4 

96 BC 
07 AC 45 
F6 33 9B 
F6 33 6k 
F6 33 6D 
F6 33 70 
07 30 ^ 

OC 56 D4 


06 5C D4 


E6 06 BF 
91 BE 
F8 BC AE 
2C 

1C 91 5C 
OE F5 
3B ^ 

56 OC 
FC 01 5C 
30 7C 
4E F6 
3B 79 
9F 56 
8C 57 D4 


M5+D,5+l 

6-»X,MX0D 4 

D*00?- YES->RET. • 

5+1, 5+1, RET. 

08+RC.l 

VY+RC.0,M5+D,5+1 

SHR,DF=1? YES > 9XYl 

SHR,DF=1? YES > 9XY2 

SHR , DF= 1 ? YES ^ 9XY4 

SHR,DF=1? YES ^ 9XY8 

M7+D, GO TO 

MC+M6,RET. 


M6+MC,RET. 


64X,M6+RF.l 
004RE . 1 


(VX+RF.l) 


BC-»RE.O |m(E)=100^^ 


C+1,00-»MC i 

ME+D,MX-D < OVERFLOW 

DF=1? NO 

D-»M6,MC->D 

D+01-*MC 

REPEAT 

ME+D , E+1 , SHR< 

DF»1? NO 

RF.1+M6 [restore V^ 
RC.0-»M7,RET. {VY +2+VY| 


R7-Hi:K-*RF 

p>k: 

[SET Rg) 


EF D3 
96 BF 
87 E3 
F4 AF 13 
30 90 


F+X,RET TO P3 
08+RF.l 
R7.0+D.3+X 
MX+D+RF. 0,3+1 
GO TO RET. 


06 57 D4 


VX»VY,RET. 
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LABEL 


LOCATION 

CODE 

REPEAT PATT — 


029E 

23 36 E2 

VO TIMES 


2A1 

70 9E 



2A3 

CO 


FXNN 

; ^ 

02a4 

45 

A3 

FXA6 

> 

02A6 

OA 

56 D4 

FXA9 

> 

02A9 

06 

5A D4 

FXAC 

> 

02AC 

4A 

56 D4 

FXAF 

> 

02AF 

06 

5A 



02B1 

lA 

D4 

FXB3 

> 

02B3 

06 

AA D4 

FXB6 

> 

02B6 

06 

FA OF 



B9 

56 

E6 



BB 

8A 

FI 



BD 

AA 

D4 

1 DKMMl 

> 

02BF 

F8 

CB A7 



C2 

86 

FA OF 



C5 

AF 

FB OF 



C8 

3A 

CC 



CA 

07 

AF 



CC 

E2 

22 



CE 

8F 

52 62 



D1 

F8 

CA A6 



D4 

06 

32 DB 



D7 

36 

DD 



D9 

15 

D4 



DB 

3F 

D9 



DD 

8F 

57 



DF 

30 

12 

FROM 70MM 

> 

02E1 

56 




E2 

05 

A5 D4 

j BNKK 

> 

02E5 

455A 



E7 

22 

E2 



E9 

86 

FA OF 



EC 

52 

8A F4 



EF 

AA 

12 D4 


CLEAR RAM 


02F2 

91 

5A 



4 

8A 

2A 



6 

3A 

F2 



8 

D4 


30MS 160MS 





TONE + DELAY— 

> 

02F9 

6© 

02 



FB 

6E 

OA 



FD 

3E 

FD 



FF 

CO 



DESCRIPTION 


DO WR.PATT,SH 

VO-1^00 

RETURN 



M54R3. 0,5+1 

MA->M6,RET. 

M6+MA,RET. 

MA+M6,A+1,RET. 

M6+MA 

A+1,RET. 

M6+RA.0,RET. 

M6+D,D»0F 

D+M6,6+X 

RA.0+D,D/MX 

D+RA.0,RET. 


"CB'4R7.0 
R6.0+D,D»0F 
D+RF.0,D®0F 
D=00? NO — 
M7+RF.0 
2-»X,STK-l f- 


VB^RF.O 


RF . 0+STK , STK+KEY , STK+1 
"CA'-4R6.0 
M6-*D,D=00? YES 

EF3=1? YES 

5+1, RET. < 1 

EF4=1? NO— J 4 - 
RF.0+M7 f 

SKIP — 

D^M6 

M5->R5.0,RET 


VB-^KEY 


A ON 


:] 


M5+D,5+l,D^MA 
STK-1,2^X 
R6.0+D,D*0F4STK 
RA.O+D,D-fMX+RA.O 
STK+1, RET. 


OO^MA 4 1 

RA.0->D,A-1 

D=00? NO- 1 

RET. 

05+VD(SET 30MS TONE) 
OA+VE(SET 160MS DELAY) 
VE^^OCO 
RETURN 
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* 


LABEL 


INITIALIZE 
RAM 
' & 

PATT. 

TABLES 


PLl 


LOCATION 

CODE 

DESCRIPTION 

0300 

6D 04 

04-»VD (TONE) 

02 

A9 FF 

09FF-»A 

04 

02 F2 

CLEAR RAM (TV PAGE) 

06 

A8 9F 

089F-»A 

08 

02 F2 

CLEAR RAM (TOP OF STACK & RAM PATTERNS) 

OA 

00 66 

TV ON 

OC 

A8 D2 

SET A=8D2 (TVA 2) 

OE 

B2 F8 

F8^TVA2,+2 

10 

B1 15 

15-*TVA4,+1 

12 

B3 11 

11-4TVA5,+3 

14 

B1 04 

04-»JH0,+l 

16 

B1 04 

04-»JHl,+l 

18 

B1 01 

01-+JH2,+1 

lA 

B1 02 

02-»JH3,+l 

1C 

Bl 05 

05--»JH4,+1 

IE 

BO 05 

05->JH5,+0 

20 

A3 2B 

SET A=PL1 

22 

69 04 

04-»V9 

24 

79 FF 

MA-»RAM (A+H) 

25 

E4 

V9-1 

27 

39 24 

V9#00 1 

29 

14 00 

GO TO 400 (GAME SELECT) 

> 032B 

03 03 


2D 

80 


2E 

18 18 


30 

18 18 


32 

18 18 


34 

18 18 



* WRITE PATT > 0336 

38 

3A 

3C 


E8 ^ 
13 ^ 
E8 3C 
CO 


C 


RAM V9-»TV HIT— I 
SKIP 

RAM V9-»TV) 
RETURN 4 / 


WARBLE TONE > 033D 

60 OF 

OF-^VO 

3F 

22 F9 

DO TONE + DELAY fn 

41 

70 3F 

vo-1^00 ' 

43 

CO 

RETURN 


draw! I — 

> 0344 

69 02 

02-+V9 


0346 

6C 06 

RIGHT-+VC 


48 

60 7F 

127^ VO 


4A 

22 9E 

DO REPEAT_PATT^; 


4C 

23 54 

DO DRAWi 32 

XXI 

> 034E 

6C 06 

RIGHT-* VC 


50 

E2 

SH f(VC) 


0351 

23 54 

DO DRAW4 32 


53 

CO 

RETURN 
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LABEL 


LOCATION 

CODE 

DESCRIPTION 

DRAW i 32 


0354 

6C 08 

DOWN-*VC 



56 

60 20 

32^^V0 



58 

22 9E 

DO^REPEAT PATT. 



5A 

CO 

RETURN 

DRAW NET 

> 

035B 

69 03 

03-»V9 

MUST FOLLOW 


5D 

A8 D3 

8D3-»A 

DRAW O 


5F 

BO 03 

03-»TVA 



61 

13 4E 

GO TO-*XXl 

RB-08 

^ 

0363 

8B FF 08 

RB.0-»D,D-08 



66 

AB D4 

D-»RB.0,RET. 


SHOW A/B SCORE — > 

0368 

69 04 

04*»V9 

f<VA) 

6A 

89 A4 

V9+VA-4V9 lV9=A/B SCORE RA^ 

3 DIGIT SCORE 

6C 

23 88 

DO A/B SCORE-»V3 


6E 

62 82 

82-+V2 


70 

93 28 

V3-»M(0882,83,84) 3 DEC. DIGITS 

CONV. & SHOW > 

0372 

EO 

ERASE RAM V9 

V9 

73 

60 02 

02-»V0 


75 

6C 06 

06-»VC (RIGHT) 


77 

23 96 

DO CONVERT M (08V2) DIGIT, V2-l«-, 


79 

E4 

MA-»RAM V9 


Ik 

E2 E2 

SH,SH 


7C 

E2 E2 

SH,SH 


7E 

E2 E2 

SH,SH 


80 

70 77 

vo-iy^oo * 


82 

23 96 

DO CONVERT M(08V2) DIGIT, V2-1 


84 

E4 

MA-»RAM V9 


85 

E8 87 

RAM V9^TV 


87 

CO 

RETURN 


A/B SCORE->V3-- 

— > 0388 

8A 

8C 

8E 

62 80 

82 A4 

93 22 

CO 

80+V2 

V2+VA-*V2,VB M(08V2)=A/B SCORE BYTE 
M(08V2)-»V3 

RETURN 

A/B SCORE+Vl— 

— ^ 038F 

23 88 

DO A/B SCORE-»V3 


91 

83 14 

V3+Vl-»V3 


93 

93 24 

V3-#M (08V2) 


95 

CO 

RETURN 


* 


CONVERT M(08V2)-> 
DEC. PATT. ADDRESS 
FOR M(08V2) DIGIT 
-^A,V2-1 


0396 

A2 

10 

98 

93 

22 

9A 

F3 

B6 

9C 

F3 

A6 

9E 

F3 

B3 

AO 

72 

FF 

A2 

CO 



2 10-»A*DEC .CONV .TABLE 

M(08V2)-»V3 

V3(LSD>»A(LSD) 

MA-»V3 
V3^A LO 
y2-l 
RETURN 
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LABEL 


LOCATION 

CODE 

DESCRIPTION 

* SHOW A 6c B — 

> 

03A3 

6A 01 

Ol+VA 

SCORES 


A5 

23 68 

DO SHOW A/B SCORE 

+1.5 SEC 


A7 

6A 00 

00+VA 

DELAY 


A9 

23 68 

DO SHOW A/B SCORE 



AB 

6E 7F 

7F+VE 



AD 

3E AD 

VEj^OO'O 



AF 

CO 

RETURN 

* STOP IF 


03B0 

6A 01 

01+VA 

A/B SCOREWl 

B2 

23 B9 

DO VI STOP TEST 



B4 

6A 00 

00+VA 



03b6 

23 B9 

DO VI STOP TEST 



B8 

CO 

return 

* VI STOP TEST- 

> 

03B9 

23 88 

DO A/B SCORE V3 



03BB 

83 15 

V3-V1+V3,VB 



BD 

4B B8 

VB=»00 

*WARBLE STOP— 

> 

03BF 

23 3D 

DO WARBLE TONE 



Cl 

13 Cl 

STOP LOOPO 


* 


WAIT FOR A/B j » 

KEY OFF — J 


MLA > 

MLB — > 


03C3 

4A 

C8 

C5 

03 

CB 

C7 

CO 


C8 

03 


CA 

CO 


CB 

36 

CB 

CD 

D4 


CE 

37 

CE 

DO 

D4 



VA^OO 

DO MLA 
RETURN 

DO MLB f 

RETURN 

EF3=1? YESV 
RET. 

EF4=1? YES O 
RET. 


* ERASE 6e SHOW 03Dl 23 68 

NEW A/B SCORE+V1-* D3 23 8F 

D5 23 68 

D7 CO 


DO SHOW A/B SCORE f(VA) (ERASE) 
DO A/B SCORE + VI 
DO SHOW NEW A/B SCORE 
RETURN 


* DIR.KEY/OO^VB-^ 03D8 

DA 

DC 

DE 

EO 

E2 

E3 

E5 


D2 

11 

KEY 2-»VB * 

D4 

E3 

KEY 4-^VB > 

D6 


KEY 6-*VB ^ 

D8 

E3 

KEY 8->VB ^ 

6B 

00 

OO^VB 

CO 


RETURN 

22 

OB 

DO KEY DEBOUNCE 

CO 


RETURN 


* STUDIO II LANGUAGE 





LABEL 


LOCATION CODE 


DESCRIPTION 


SHOW TVA LIST > 03E6 

61 D1 

SET V1=TVA1 ADDR. 

E8 

69 01 

01-*V9 

EA 

F2 AC 

MA»V2,A+1 < 1 


EC 

92 14 

V2-»M(08V1) 


EE 

E8 FO 

RAM 1 TV 


FO 

70 EA 

V0-l?^00 * 


F2 

CO 

RETURN 



03F3 

00 


* USED 

> 03F4 

22 OB 

DO KEY DEBOUNCE 

IN B KEY 

6 

92 11 

V2-»Vl 

TEST 

8 

23 Dl 

DO ERASE & SHOW A/B+Vl 


A 

61 64 



C 

23 B9 



E 

17 F8 

GO TO 07F8 (KEY B TEST) 
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IMAGE STORAGE LOCATIONS, 09MN 










STUDIO II LANGUAGE 


:i ff 1‘ ! 
2 MUM 
CO 

3XMM 
4XMM 
5XKK 
6XKK 
70MM 
7XKK 
eri’i 
8XY2 
8XY3 
8XY4 
8 XV 5 
9X\'() 
9XY1 
9X^2 
9XYA 
9XY8 
AMILM 
BNKK 
CXKK 
DKMM 


EO 

El 


K8;ir} 

EXI-.O 

FXA 6 

rAA9 

FXiC3 

r An L, 

FKAF 

FX4n 

8 XY 6 

8XYE 

¥9 

VA 

VB 

¥C 

VD 

\'V. 

VF 


Fxc'f.nc Machine Lanp.unge Routine 
Co to OM'D! 


o ♦“ flMKCW 

O V. V/^L U U A I 


Q TiJt 

jur^ U.V/ Jixc: k. u A. 1 1 


Do Subroutine at OMMI-1 (CO to Return) 

Return from Subroutine 
Co to MI (Same Page) If VX ^ 00 

Co to MM (Same Page) If VX - 00 

Skip 2 bytes if VX ^ KK 
KK *■ VX 

VO -1, Go to MM (Same Page) If VO 00 (Note VO >= 01 If No Branch) 

If X 0; VX + KK 

VX/VY -> VX, VB 

VX-VY -r VX, VB 

VX 0 VY -r VX, VB 

VX 4 VY a- VX (01 VB If VX 4 VY > FF, 00 -»■ VB If VX 4 VY - FF) 

VX - VY -> VX (01 -r VB If VX ^ VY, 00 -r VB If VX < VY) 

Skip 2 Bytes If VX VY 
VX -»• \Y 
M(08VY) -r VX 
VX + M(08VY) 

VX ^ M(08VY , VY 4 1, VY 4 2) Decimal, VY(FINAL) = VY 4 2 
OMMM + A (Memory Pointer), for TVA (TV address) . 

KK ^ M(A), A 4 N (Same Page) 

RR*KK •> VX, X 7^ 0 

KEY(K) VB • Go to MM (Same Page) 

"A" Key if VA «= 1, "B" Key if VA = 0, Do next instruction if 

KEY(K) is not pressed. If K = F, Go to MM if KEY(VB) is 

pressed. 

Erase V9 RAM Pattern 

Shift V9 R^\M Pattern f (V9 Direction Byte), NV/NH - 1 
Skip if direction ^ U/D/L/R (2/8/4/6) 

'MM ft V9 RAM Pattern f (VC), NV/NH-1 , Skip if VC / 2/8/A/6 

H(A) H Bytes XOR V9 RAM V9 RAM, A(FINAL) - A 4 H, Skip if H - 0 

Move V9 RAM Pattern TV(XOR), Go to Ml if Hit 
VX(LSD) -> A(LSD), VX(FINAL) - VX • OF 
M(A) * VX 
VX MCA) 

VX > ALO 

H(A) >■ VX, A 4 1 

VX M(A) , A 4 1 

Set X (Preset R6 for OMMM Next) 


VY/2-4VX, underf low-4 VB 
2 *vy-- 4VX, overf low-4 VB 

Current RA.M Pattern if (00-07) 

A/B Key Flag (01 = A, 00 = B) 
Arithmetic Overflow/Key Input Byte 
Direction Byte 
Tone Timer (Q On if VD 00) 

Timer 

Timer 


Special-Purpose 

Variables 


* Programs begin at 0400. In ROM systems 400-7FF program storage will be read onjY 
Do not use 3 byte COSMAC instructions in machine language routines. 



